home *** CD-ROM | disk | FTP | other *** search
/ Merciful 1 / Merciful - Disc 1.iso / software / r / rexx_plus_compiler / rexxpluscompiler2.dms / in.adf / RexxPlPlot / RexxPlPlot.zoo / README < prev    next >
Encoding:
Text File  |  1990-03-17  |  8.5 KB  |  228 lines
  1. This file is the reverse chronologic README for PlPlot.  The good stuff
  2. is at the end.
  3.  
  4. -------------------------------------------------------------------------
  5. New version (V0.3, January 1990):
  6.  
  7. Bug fix in IFF and Portrait Preferences support:  when drawing 3-d plots,
  8. `down' was defined incorrectly, so the plots would be botched.  Fixed.
  9.  
  10. Will compile under Manx or Lattice; Lattice recommended.  IMPRESS mode
  11. (probably) doesn't work when compiled under Manx due to stdio library bugs.
  12.  
  13. Sample use (to test):
  14.  
  15.     rexxplplot examples/example08.plot
  16.  
  17. and give it time (it's plenty slow.)  The supplied `plplot.lib' and
  18. RexxPlPlot was compiled under Manx.
  19. -------------------------------------------------------------------------
  20.  
  21. Things I did:
  22.  
  23.     Make RexxPlPlot compile under Lattice and Manx.
  24.     Added IFF support.
  25.     Added Preferences support.
  26.     Added `plthicken()' and `pliff()' (described below)
  27.     Added call to macro file at beginning for easier use
  28.  
  29. So, now, simply:
  30.  
  31.     rexxplplot [macrofile]
  32.  
  33. and everything will work just fine.
  34.  
  35. Two additional functions:
  36.  
  37. plthicken()
  38.  
  39. Called right before you print.  Thickens all lines in the plot by a single
  40. pixel width.  Only works for the IFF and Preferences output devices.
  41. Very useful on those 300 dpi devices.
  42.  
  43. pliff(xdpi, ydpi, xsize, ysize, filename)
  44. int xdpi, ydpi, xsize, ysize ;
  45. char *filename ;
  46.  
  47. Sets up the IFF parameters from C (or ARexx) so the user isn't prompted
  48. for them.  If any of the integer parameters are zero, no value is assumed
  49. and the user is prompted.  If the filename is NULL or "", the filename is
  50. prompted for.  Thus, you might use a call at the very beginning to set
  51. the numeric parameters of the plot, and then later several calls to set
  52. the output filename, one for each plot.  In order for the numeric parameters
  53. to work, they must be set *before* the call to plstar() or plbeg().
  54.  
  55. Here's a sample self-contained REXX script:
  56.  
  57. /* Example09.plot - Demonstration of contour plotting */
  58. /* Modified for RexxPlPlot by Glenn M. Lewis - 9/12/89 */
  59. /* Modified slightly for IFF files by Tom Rokicki */
  60. address 'PlPlot'
  61. say 'Please be patient...'
  62.       
  63. NPTS=41
  64. /* Special RexxPlPlot function */
  65. 'plset_tr(0.05,0.0,-1.05,0.0,0.05,-1.05);'
  66.     do i=1 to 11; clevel.i = (i-6)*0.2; end i
  67. mark=1500
  68. space=1500
  69.  
  70.       do i=1 to NPTS
  71.         xx = (i-1-(NPTS/2))/(NPTS/2)
  72.         do j=1 to NPTS
  73.           yy = (j-1-(NPTS/2))/(NPTS/2) - 1.0
  74.           z.i.j = xx*xx - yy*yy;
  75.           w.i.j = 2*xx*yy;
  76.         end j
  77.       end i
  78.  
  79.       'pliff(60,60,640,400,"f1.iff")'
  80.       'plbeg(10,1,1);'
  81.       'plenv(-1.0,1.0,-1.0,1.0,0,0);'
  82.       'plcont(z,NPTS,NPTS,1,NPTS,1,NPTS,clevel,11,xform);'
  83.       'plstyl(1,mark,space);'
  84.       'plcont(w,NPTS,NPTS,1,NPTS,1,NPTS,clevel,11,xform);'
  85.       'pllab("X Coordinate", "Y Coordinate","Contour Plots of Saddle Points");'
  86.       'pltext();'
  87.       'plend();'
  88.  
  89. exit 0
  90.  
  91. Enjoy!
  92.  
  93. -tom
  94.  
  95. -------------------------------------------------------------------------
  96.  
  97. This is RexxPlPlot V0.2 - written by Glenn M. Lewis - Caltech - 9/89
  98.  
  99. To try out the examples, open two CLI's (or Shells) with large stacks.
  100. In the first one, type "RexxPlPlot".  When it announces that it is ready,
  101. go to the second one, and type "rx Example01.plot", or whatever example
  102. you wish to see.  Once the 'plstar(nx,ny);' routine is called, you will be
  103. prompted in the original window for an output device.  Make your selection.
  104.  
  105. Please be patient.  ARexx is an interpreted language, and is significantly
  106. slower than compiled C.  If you just can not stand waiting any longer, open
  107. a third CLI, and type "rx 'PlPlot' 'plend'" which tells RexxPlPlot to shut
  108. down.  You will then have to go to the RexxPlPlot screen if you chose #1,
  109. "Amiga" output, and hit a carriage return to close the page.
  110.  
  111. Good luck, and have fun.  Using ARexx as a front-end for PlPlot is, as I
  112. hope you will see, very useful and versatile.
  113.  
  114. Glenn M. Lewis
  115. glennl@vlsi.caltech.edu
  116. glennl@tamcad.intel.com
  117.  
  118.  
  119. -------------------------------------------------------------------------
  120.  
  121.             PLPLOT Version 1.1
  122.             ------------------
  123.  
  124. This is an update of the excellent package that Tony Richardson
  125. released recently.  My modifications are broken down in three areas:
  126. changes and corrections in the documentation files, modifications
  127. necessary to generate a link library with the Manx compiler, and the
  128. addition of a PostScript driver. 
  129.  
  130. Since the package is fairly large, instead of redestributing all of
  131. it, I have provided a patch file, that used as input to the patch
  132. utility (see FF#129), will make the changes automatically in the
  133. version that was posted to Usenet.  In order to accomplish this you
  134. should cd to the directory above src, include, and docs directories.
  135. Then issue the command "patch <plplot.patch", and all changes will be
  136. made automatically. 
  137.  
  138. Afterwards you should copy the directories in this update to the
  139. corresponding directories of the original distribution.  Note that in
  140. the src directory I have enclosed a Makefile that will generate the
  141. library for either Manx or Lattice depending on which definitions are
  142. uncommented in the file.  You should use the Manx make utility, or
  143. other PD ones.  In addition, I have included the AmigaDOS scripts
  144. CompExam.manx and CompExam.lattice in the examples directory.  These
  145. are modified versions of the original file CompExam.  As the examples
  146. link the plplot libraries from the corresponding compiler library
  147. directory, you should copy the corresponding library there before
  148. compiling the examples. 
  149.  
  150. Finally, you need to add the following three macros to the Manx math.h
  151. include file:
  152.  
  153. #define abs(x)        ((x)<0?-(x):(x))
  154. #define max(a,b)    ((a)>(b)?(a):(b))
  155. #define min(a,b)    ((a)<=(b)?(a):(b))
  156.  
  157. I don't think that all three are necessary in this case, but they are
  158. useful nevertheless. 
  159.  
  160. Note that since Tony Richardson did not mention a version number for
  161. his release, I have taken the liberty of calling it version 1.0, and
  162. subsequently calling the present update version 1.1. 
  163.  
  164. Any questions or comments regarding this version of plplot may be
  165. directed to:
  166.  
  167. Dr. Samuel Paolucci
  168. 1351 Roselli Dr.
  169. Livermore, CA 94550
  170. ARPA: paolucci@snll-arpagw.llnl.gov
  171.  
  172. -------------------------------------------------------------------------
  173.  
  174. PLPLOT is a library of C functions useful for scientific plotting on the 
  175. Amiga personal  computer.  The  library  is  Lattice C  compatible.  For 
  176. those of you with  another compiler or who  want to modify the code  the 
  177. source is provided in directory src.
  178.  
  179. Contour plotting, three dimensional plotting, axis redefinition, log-log 
  180. plotting  and  multiple  subpages are a few of  PLPLOT's  features.  The 
  181. plots can be displayed on your monitor or a graphics file can be created
  182. which can be sent to a hard copy device.
  183.  
  184. To see some of the features of this package I suggest you go to examples 
  185. directory, READ THE README FILE THERE, and  then  compile and run one of 
  186. the example programs.
  187.  
  188. The documentation is in the docs  directory  and is written in LaTeX.  I 
  189. apologize to those who don't  have  AmigaTeX or easy  access to  TeX  on  
  190. another machine.
  191.  
  192. This is Version 1.00 of PLPLOT for the Amiga.  I had hoped to add a few
  193. more features to the package before releasing, but  this work seems  to
  194. have taken a back seat to work on my dissertation at present.  The wish 
  195. list includes:
  196.  
  197. (1) Color support for the Amiga screen driver.  I have  written drivers
  198.     for a few hard copy devices  that do  provide  color support and it
  199.     would be pretty easy to do on the Amiga. I don't have a need for it
  200.     though and it does require more memory.
  201.  
  202. (2) Device independence.  I would like to have PLPLOT produce a  device
  203.     independent file and then have  separate drivers that use this file
  204.     to generate  hard  copy.  Presently  new drivers must be integrated
  205.     into the package.  This would take a little time to  accomplish and
  206.     I don't see myself doing it in the near future.
  207.  
  208. This is FREEWARE.  It's my way of saying thank  you to those people who
  209. have  written  freeware  for the  Amiga  in  the  past.  Feel  free  to 
  210. redistribute this package to anyone who  wants  it.  I do ask that only  
  211. this version  (unaltered)  be  distributed  and  that  the  package  be
  212. distributed in its entirety (including the documentation).
  213.  
  214. Let me know if you have any comments, find  any bugs, or are willing to
  215. work on translating the package for use with another compiler. I prefer 
  216. being contacted by mail, either electronic or US.
  217.  
  218. Tony Richardson
  219.  
  220. email    amr@dukee.egr.duke.edu
  221.  
  222. US-Mail  Tony Richardson
  223.          Duke University
  224.          Dept. of Elect. Eng.
  225.          Durham, N.C. 27706
  226.  
  227. phone    919-684-3123 (work)   919-286-7101 (home)
  228.